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The shell game 



Back when I^DOS Insidt and Out was written, an appendix was 
included that was intended to help those who wanted to choose 
between the use of FKjDOS or DOS 5.3 to make thdr dieefsbw. A few 
of Qie ffl'guments are sffi vsM, hut 4ni£ has talwn us to a point 
where DOS 3.3 cannot be constdefttf a viable option for Apple II 
users wishing to be afljOiitig other than anachronistic, (Unfortunately, 
those of us who make our Eirguments public have to live with them 
for a long time.) Three things have occurred since the time the book 
was written to alter the impact of the discussion in that FroDOS 
Inside and Out appendix. 

First, Apple delivered Apple Worlds, which became a major force as 
the integrated application that sold hundreds of thousands of Apple 
lie and Uc computers. AppleWorks was a child of the ProOOS operal- 
irig £^stetn; if you wanted to use ^pleWorks, you had to use FroDOS. 

Second, Apple released the UailMsk 3.5, the first masSHitarket 
removable media drive with a respectable storage capacity (800K ver- 
sus the paltry 140K of standard Apple 5.25 drives) accepted by Apple 
II users. ProDOS is clumsy when limited to !40K disks, but becomes 
elegant on larger capacity devices. DOS 5.5 is just the reverse- 
acceptable on lower capacity disks but visibly out of Its element on 
large volumes. The UniDisk 5.5 propelled a move to a "mass storage 
environment" that Apple's overpriced Profile hard disk never man- 



The third factor had nothing to do with Apple; this was the aufpr- 
ance of programs that made ProDOS easy to use for the of lis. 
Apple's utilities and manuals were universally horrific for neophyte 
users. The single mo.st important oversight was an explanation of how 
to exit one program and start another without re-booting each time. 
Apple's standard user manuals, although they do explain the con- 
cepts of files and directories, don't effectively explain the mechanics 
to their customers wishing to use ProDOS 8 (the Jigs Finder solves 
many of the problems if you are a Ilgs user booting through G5 OS). 
For example, let's assume you have booted into AppIeWorte and wish 
to quit and run a communications program to download a file. How 
do you get to that next program without rebooting? 

The ajncept is one of a progrsati seiecte soRware %at aOous you 
b) select the next program you wish to use. ProDOS 6 incM^S a 
mechanism that allows AppleWorks (or any program) to request iPro- 
DOS to execute a self-contained routine intended to allow the user to 
select the next program, Unfortunately, ProDOS's standard routine is 
intimidating in the process it uses. The first prompt a user meets \at 

EHTER PREm, (PRESS "RETOEN" TO KCEPT) 

and FroDOS expects you to provide a name that indicates the default 
directory you want FroDOS to use. Wext you'll be asKed to: 

SHiEit tamm of next application 

How ProDOS expects you to type the fllorame {or pathname, if the file 
is in a directory other than the one specified by the prefix) of the next 
program you intend to run. 

What's wrong with this system? Once you are looldng at the 
prompt, ProDOS won't let you list the volume names or file names for 
any disks! The standard ProDOS selector doesn't accept slot and drive 
numbers or any command to list the contents of disks; you have to 
know where you're going before the ProDOS selector will let you 



there. 

Thankfully, Apple has documented the iocatkin of FtaDOS's selec- 
tion routine and the protocol for startbig new programs in sectton 
5. 1.5 of the FroDOS 8 Ttchnica} J?e/ereflre ManuaL It is possiiile to 
replace the normal selector with a more useable program: selector. 
The Windows utility on our monthly disk installs replacement selector 
code Karl Bunker added to the program (the assembly language 
source code is included In the STAMDARD.TOOLS subdirectory as 
WinD.QUIT.S). 

Program selectors come in three general styles with regard to 
how the user selects the next program: the use of a command line 
(you ^pe the progam's name), a menu-based system (the program's 
name is displayed as an element of a list), or a symbolic model {the 
program liie^ reprinted by an image). 

A command line Interface (we'n call It a "shcir, to indicate that it 
serves as a protective shell around the raw' internals of the disk oper- 
ating system) expects you to memorize a few command "key words" 
that allow you tell the program what to do. The key words themselves 
var\' from one shell to another, and are often cryptically abbreviated. 
For the MS-DOS shell interface, the command to list files within a 
directoiy is 'DIR' (short for "directory"), the same command for a unix 
.system iis "Is* (short for "li.st"). By specifying a keyword along with a 
filename, you can perform operations on specilic iiles; for example, 
in MS-DOS -ERASE THlSnLE.'TXT' tells MS-DOS to ERASE (delete) the 
file TmsriLli.TXT from the disk. 

One problem with using a shell as a standard user interface is that 
there can sometimes be hundreds of commands (and hundreds of 
filenames) to remember; commands to copy files, configure devices, 
arid so on, Many users consider this to he Q>nfusing. But if we limit 
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our use oT a shell to findbig and execuOng a pro^^ain, the number of 
commands needed fe often reduced to only a Few. This Is the case 
with the Apple K; after all, Apple does giv e you uMlily programs to do 
thin^ like copy and delete files, so if you know how to run the pro- 
gram everjlhing falls into place. 

Ibe classic Apple n shell involves the use of disk commands 
front BASIC. This Interface was built into DOS 3.3 Itself, but for Pro- 
DOS it requires the use of a specific program represented by the 
BASIC.System file found on Apple's ProDOS 8 system disks. When 
you boot ProDOS, it looks for the first file of type °SYS' (the filelype is 
Shown when you list Ae contents erf a PtoDOS disk or directny with 
most utilities) with a name encSng in '.SYSXEH' and executes Oiat 
pxjgram . TbmSort^ if you tailtbl^ a new troDCS didi with your (i*rD- 
DOS) system uHWies and copy the files PRODOS and BASIC.System to 
the disk, you can Ixxjt that disk and initially use BASIC.System as 
your shell, 

Selecting a disk. From BASIC.Syslem, there are three commands 
that you need to know in order to execute most files. The first com- 
mand, PREFIX, allows you to select which disk tor ProDOS directoiy) 
you will be dealing with, assuming you either Know the name of the 
disk w the slot and drive wh^e the disk is located. 

If you loiow Itie c^ is instaBed Jnadiive and jnu tcoow the disk's 
name, ustm T^tlK followed tig the nane idl BASKLSystem you 
want that a»i established as die one to use % defW tot exam[^, 
if you have inserted your Applelinlis master named /APPI.EWORKS/. 
the command: 

will tell BASIC.System you want to deal wifli the /APPLEWORKS vol- 
ume. (Notice that a RroDOS volume name always begins with a 7' 
character; a trailing T is optional.) If a disk with the name of /APPLE- 
WORKS/ can't be located. BASIC.System will return a 'PATH nOT 
rOUhD' error If the disk appears to be damaged, BASlC.Sy^em 
returns an "1/0 ERROR" message ("1/0" is short for 'input/outpur. 
Indicating the transfer of data to or from the disk). 

If you don't know the name of a volume but you do know the slot 
and drive ass^[i^i^ of your disk drive, you can let BASIC.System 
find the volume name and select that volume for use by inserting, the 
disk into the drive and using two parametm set oFT by commsQ. The 
Ihst, 'Sn" {where "n' is tire slot number), provides the slot number of 
Bie disk; the second, "On" (where "n' is the drive number), provides 
the drive number For a ProDOS dish inserted in slot 6, drive 1 (Uie 
normal location for a 5.25" startup drive) the command would be: 

!ilfB,S6,Dl 

Typing PREFIX without any parameters will display the current set- 
ting for the prefix. If there is no prefix currently specified, FFtEFIX 
(without parameters) will attempt to access the dclaull disk (usually 
tlie last disk device accessed using slot and drive numbers; if the 
dr^e is empty, you'l! get an 1/0 ERROR message} and display the 
name of any ProDOS voimne found In that drive. This does not 
'select' the volume so to set the fNtefix to the volume in the defjauit 
device you tieed to use two commands: 

to dlspl^ Ifte name and (contbiltis wtti the txartipte of /APPLE- 
WORKS/); 

(Hiat is^ PREFIX plus the nane returned p8»^ous^) to select the vol- 
ume. 

Once you've identified Sie name of a volume, Ws a good idea to 
add the name to your disk label if it isn't already there. In the future, 
all you'll need to do is look at the label to confirm the disk's name. 

Selecting a directory. The second command allows you to list the 
files on a disk or in a subdirectory, and that command is CATALOG. 
CATALOG produces an 80-colume listing, so BASIC.System also pro- 
vides a form called CAT which produces a listing tailored to the 40- 
column screen. 

CAT (or CATALOG) used by itself will attempt to list the contente of 
the last accessed disk or of the cmiiont dlNsctoty^ Assuming you have 
used F^FIX to s^ecta s{)edBc <Ssfc, ttte cuneat db^iy wni be the 
root dbectoQr of ttat <^ For oiv /l^teWbftts 3.0 masta- (3.5) tSsk 
for tmnpte. CAT produces the fbUov^g M of lilies: 
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NAME 


TYPE 




HODU'IED 


PRODOS 


SYS 


32 


22-MAR-89 


jmm.sism sis 


26 


3'JkIS-l9 


08.00 


•m: 


f 




SKM 




S 




SSSM 


BIN 


} 


3-WS-4S 


SEG.AM 


BIN 


9 


3496-89 


SEG.El 


BIN 


12 


2T-DIC-8S 


SES.FR 


BIN 


3 


3-AOG-89 


SEG.ER 


BIN 


6 


3-ADG-89 


SEG.AM 


BIN 


n 


3-iD5-aS 


»G.n 


m 


«l 


3-UG-8S 


5B.DB 


BD 


fit 


3-ffl&-8S 


SK.SS 




7S 


3-JU)G-fl9 


iiaiN,DiciiOKARi m 


395 


14-JDL-B9 


CnSLDICTIOlORY TW 


1 


15-JTIN-89 


FASTCOTl 


srs 


40 


17-m-B7 


UTTER 


JINF 


3 


Je-JUN-B9 




m 


4 


26-jgN-a9 


inow 


m 


( 




tut 


m 


1 






&b 


3 




SFmD 


ASF 


3 


26-JTIH-39 


S«IPI£.fIUS 


DIR 


2 




BLOCKS RB: 


2g» 


mSS DSD: 13U 



Each file listing contains, among Other items, two Sfiednc Items we 
are interested in. One is the file name: 

tfnoRxs.BiesBM m u i-m-n 

and the other is the file type: 

The file name used to Identify the specific file we are interested 
In. For the purposes of trying to run a program, four types of files may 
be of interest; the CAT command displays these as "SYS" (system 
file), "BAS' lApplesoft BASIC program), 'BIM' (binary file; this may 
contain an executable program, or It may not), and "TXT* (text file; a 
limited number of these known as "EXEC" files can be executed with 
BASiCSystem). notice that 'SYS" and 'BAS' flies are usually exe- 
cutatde programs (there may be occasioiid excef^ons), Mt that 
7(11!' and nxr fites most ofti^ ax not executable pogrms^ (at 
teist, tfs iMi^ not to assume ttiat they are programs). Hmtt h m 
100% reliable way to assure that a file is an execuUble prb§am< but 
the above rules serve as a practical guide. 

There is a fifth file type that may be of interest; the "DIR" flie. This 
is a subdirectoiy that may contain further sets of files. If you don't see 
the file you want to execute in the volume directory, you can use PRE- 
FIX followed by the subdiredoiy name to enter that subdirectoiy: 

nsnx sums 

(notice that the subdirectoo' name is not preceded by a and 
then use CAT to list any files it contains. CAT (without a pathname) 
will only allow you to see the files for the directory that you have cur- 
rently specified. To return to the volume directoiy for the disk, you 
a^n must type: 

PREFIX /MPLESORK 

(see, we left off the trailing "/" this ditiey. This method of maneu- 
vering through directories b tedious, but tlti^ the advantage of ticlltig 
systematic. On the AppleWorks disk, you can use llie sequence: 

PREFIX Im^mmj 
or. 

FR£riX SAMPLES 
CAI 

{lEnX IDVUCED.FIIfS 

cu 
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to locate the "ADVAMCED.nLES" directory within the "SAMPLES" direc- 
tory on the "/APPLEWORKS/" volume and list the llles it contains, 
finding no executable files, you return to the volume directory. 

There is a shortcut, if you know precisely where a subdirectory of 
interest Is contained, you can combine the names of all the directo- 
ilesjfC)]! pm^ through ia to one long 'patti Joaroe" tq the subdirectory 
and leei 'iiff&m. IftEHX mtMmmmd Sm. 

Pteitic5e that one {and nomofe ihan one) 7' character is used to seps- 
rate each directcay name frorn the next, and that the order of the 
ncsmes (from left to right) Is the same as that used in the individual 
PREFIX commands above (from top to bottom). There are other tricks, 
but we won't try to rewrite ProDOS Inside and Out here. 

Selecting a program. There is no clear rule for identifying the pro- 
gram file you are looking for, other than to know from reading the pro- 
gram's documentation or by experience (that is, you tried it before 
and it ran consistently). One of the files you will notice on the Apple- 
Works disk is AFLWORKS.SYSTEM, and that has 3 high probability of 
being a main pw^raffi fite because Ills a 'SY5' file and It follo(*s ttie 
ftoDOS ".SYSTEM' naming convention, indicating it la intended to 
startup on booting the AppleWodui disk. So. after u^ng: 

to select the directory, all we need to do Is to try and execute the file. 
We do this using the BASIC.System "smart run' command, which is 
just a dash followed by the name of the ffle we want to execute: 

■imm.sism 

the dfek should spin and well be th AppIeWorte. 

Selecting the proper pre/Jx is a necessary step! The 
APLWORKS. SYSTEM file uses the value of the prefix to locate other 
nies it needs to use (the files labelled with names starting with "SEO.", 
among others). It is not uncommon for programs to use the prefix in 
this manner. 

Once you're convinced AppleWorks is running, you may want to 
quit and get back to your program selector. However, this won t be 
BASlCSystem; as we mentioned earlier, standard ProDOS lias its own 
selector. As you learn the prefix and ttie filename to enter for your 
disks, you can elect to use ProlXK's selectoc Or, like most people, 
you may prefer to avoid the standard ProDOS selector as much as 
possible. 

One alternative, if you've mastered launching programs from 
BASIC.System, is to make up a "selector disk" containing BASIC.Sys- 
tem. You can then insert this disk and supply its name as the prefix 
and "BASIC.System" as the application. Then you'll be back to a 
"selector" with more options. To exit back to the selector Installed in 
ProDOS, just type "BYE" from the BASIC prompt. 

But even If you become familiar with BASlCSystem, there are 
firtt# where ft won't be accefitsCbte as a selected ^«he programs are 
too iai^e to execute directi^ white BASIC.System is in memory, And 
some people won't ever find using a shell acceptable to them. An 
option is to replace the ProDOS selector with something more palat- 
able; alternative selectors are available from sources of public 
domain software or shareware (Including on-line services and user- 
group libraries) and commercially. 

Augmenting Apple's system. Several smaller selectors have 
been made available that fit completely in the same space as the 
standard ProDOS selector, such as Squirt ($8.50 from Synesis Sys- 
tems, P.O. Box 1308, Qitbert, Ariz. 85234), and Bird's Setter J3ye 
^valfabie on iti^jf Beagte Reds products, on iNS' monthly disK, snd 
on some other cofflmercial products). These selectors are more of the 
"menuing" type. YOu select the disk volume you want to deal with 
(either from a list, or by "toggling" to each device). The selector dis- 
plays a list of directories and SYS files on the chosen disk; you select 
the' subdirectory, and then you select a "SYS" file to run. Most of 
these selectors, like ProDOS's built-in selector, will only execute files 
of type "SYS". 

Another option is to replace ProDOS's selector with a small pro- 
gram that attempts to load a more complicated and capable selector, 
This has the disadvantage of requiring that a disk with the program for 
the IsBg/st selector be available when you return to the selector. On 
the oM I40K floppy dlste, this inconvenience may outweigh ease-of- 
use, but with larger dbks (3.5 disks, RAM disks, or hard disks) the 



space required is negligible and the ease of use increases tremen- 
dously as the number of files on the volume increases. The selector 
can be any one of the three types mentioned. 

The extended 8-bit selector that we had our first experience with 
(and primarily still use) is Qlen Bredon's HxtSel. it is based on a men- 
uing ^stem that allows the user to predefine a set of applications 
with their location (by "prefix" pathnsne Slid file nSffte) ^d iiflitt to 
pass the name of a file to applications that accept a 'startup* path. A 
common example of a program which accepts a startup path is 
BASIC.System itself, which normally will attempt to execute a file with 
the name of STARTUP (We feel compelled to mention that ProSef con- 
sists of a complete set of disk utilities, and not just the program selec- 
tor.) ProSel, for us, made ProDOS friendly. Other extended selectors 
such as Quality Computers's EasyDrive and RAH-UP, FUFS ($39.95 
from North Yo* Software, 3000 Victoria Park Avenue, Suite 520, 
rsoiii York, Ontarto M2J 4V2, 4IM§50615), and so on have 
appeared. 

Extended selectors based on the shell model are Don Elton's ECP- 
8 (included on our June 1989 disk), Dave Lyons's Davex ($25 from 
DAL Systems, FO Box 875, Cupertino, Calif. 95015-0875), and those 
supplied as part of a programming environment such as Kyan Pascal's 
lilX or ORCA/^Ts shell. These selector's provide more control over Pn> 
DOS than BASIC.System and can also execute files of commands; 
programmers tend to like them since their functionality can be 
extended by adding new commands that execute within the ftaate- 
work of the selector. 

S^mbottc selectors. There have also been graphics-based selec- 
ts M awDOS 8 including Quark Catalyst and i^oHsePesfc T|b^ 
use p^iMc symbols ("icons') to depict files; the flics can tse selected 
usin| a PJjnting device (ideally, a mouse). These have not survived 
well: IJie size and system requirements required to operate these 
selectors apparently was too extreme for most Apple II users. Apple 
apparently believed so strongly in this type of interface that they start- 
ed building computer systems based entirely on this metaphor (the 
Lisa, the Macintosh, and the Ilgs in native mode). Many Apple 11 users 
apparently disbelieved so strongly that Qiey elected not bo switdi to 
j^pple's newej lines of macbiiji^f 

Our experfeiKe with the t^^rnvi fioi^)E^ programs demon- 
strated to us that you can either use most of the Stystem resources to 
produce pretty pictures, or you can use them to do work, and we gen- 
erally chose the latter option. 

The acceptance of the Ilgs Finder is wider because, like the Mac, 
the Ilgs was designed with the icon-based interface in mind. With Sys- 
tem Software 5.0, the performance of finder is not so poor as to 
make us disregard it. There are ways to customize the selection mech- 
anism in the Ilgs Tinder that makes it attractive to many users; we 
plan to look at some of finder's features as a selector next month, as 
well as mention some Ilgs alternatives.— DJD 

Miscellanea 

QEnle ts emerging from the iMittte in Eiin>pe at ML ffill 
Louden, general manager of the QEnie service, announced the avail- 
ability of QEnie in Germany, Austria, and Switzerland on March 23, 
1990. The United Kingdom is expected to follow within three months, 
and then possibly the Metherlands (QEnie also hopes to eventually 
provide the service in East Qermany), A2-Central will be mailing out 
sign-up instructions to subscribers as QEnie opens for business in the 
individual countries. 

The local access rate within the first three countries will be $18 per 
hour for non-piime tune aK3 $27 per hour for prime time (QEirfe Is 
trying to create a single end-user price sfirudure for all of EUrppe), 
Currently, the price is in U.S. dollars. 

This announcement follows on the heels of the announcement of 
Compuserve Forum, a European arm of Compuserve, which begzui 
opeifengout of Berne, Switzerland and Bristol, En£^and on Tebruary 
1. 

Barney Stone has decided to distribute DB faster Version 
Five as shareware. This version of DB Master supports up to 200 
Tields per lecord, 250 characters pa- Rekl, and fil^ up to 10 
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megabytes in size (either using a iiard disk or multiple floppy disks). 
The shareware price for the product will be $45, which entilles the 
owner to the latest revision of the program, a full instructional manu- 
al, and a special offer on DB Master Professional (which remains a 
normal retail product). Barney expects many users to upgrade to DB 
Master Profos/on a/ once they've seen what Version Five will do. 

DB Master Version five requires an enhanced 128R Apple lie, 11c, 
11^, or Laser 128 computer with at least two 5.25 drives or one .1.5 
drive. The program can be Installed on a lYoDOS compatible RAM 
disk or hard disk with at lea^ one-half megabyte of available .storage 
Mare information }& available from Stone Edge Technologies, Inc., 
F.Q. Box 3200, Mapte^ Glten, Fenn. 19002, 215-641-1825, 

Hie Spring 1990 AtDAlog (from APDA, Apple Computer, Inc. 
20525 Mariani Avenue, M/5 33-Q, Cupertino, Calif, 95014, {408) 562- 
3910 mentions that membership in APDA will no longer be required 
in order to purchase final copies of development tools and refer- 
ences. The materials will be available through a new Developer Tools 
Express service, though the service does not include other AFD,^ priv- 
ileges such as receipt of ttie quarterly APDALog issues and the ability 
to order prerelease (beta) vesioiis of products, 

l%lifj#-/tf 3.0tm stiwMM« features. Although the piDgcam 
fs ^Tl deslped to run on Bie I28R Apple lie and Ite models (includ- 
ing the llgs in 'lie mode*), several enhancements have been added, 
including the ability to import llgs super, high-resolution graphics. 
Support for Epson LQ series printers and the j^ple Scribe has been 
added, and color printing is supported, 

In addition to the abifity to use an ^Epanded memory card to hold 



the program itself for faster operation, PubiisMU now has an option 
lo also load all fonts into memory if you have approximately 400K or 
more of memory available. 

The "Save Settings" command has been enhanced to allow .saving 
defaults for all options in effect at the time of the save, including set- 
tings for custom guides, page size, viewing display size, display of pic- 
tures in the document, rulers, pen and fill choices, the default font 
selection, and more. This option does not save your document, so 
you can u-se EL to determine tile staitup conditions you prefer for Pub- 
liStKttL 

Mew features in the Page Layout setH6n Include Qo to Page {by 
number), user defined guide settings, new editing functions (cut, 
copy, paste, move to front and move to back) on grouped objects, 
and new object attributes (Don't Prtot, Locked, Doa't iRunaround, 
PostScript, and Color). 

By turning oil Runaround lor an object, you can make text "flow 
around" the object. Using this in combination with the Transparerit 
option (to allow overiaid objects to be printed) you can create special 
effects such as dropped capital letters (a sirige large letter leading 
into a paragraph). 

The FosScript attribute indiG^es J'i66lfe^^ M% Rew abiflly to use 
encapsulated fostScrfpf (EPS) fBcs. EPS Is a standard format for 
graphics and text objects consisting of a text file in a standardized 
PostScript command format By importing an EPS file into a text 
frame scaled to the desired size of the printed object, the EPS data 




One of these days I'll beat the deadline by 
enough lead time to nnd the subtle errors, like 
fOl^^ng tiK address InfomaUon for prod- 
uct$ we mentioned Jiasf month. The disk 
labeib'ttg pragram we mentioned in Afull ^DSsk 
Lsite^', p. ^25) is DiA jUtAef Feo, avs^bk 
firm Hanfsoft ProdnOs, P. O. Box 90012, 
ffiviofu/u. Hi. 96835, for $30 (postpaid; 
includes 100 iabels for 5*25 distfs and 20 
labels for 3.5 dSsks) ml ^ecUm^ Leambig 
(ISSN 0278-3258) ntenUoned in 'Peisonna 
moves rock Apple' (March 1 990} Is $23.95 per 
year (8 issues); the address is P. O. Box 2(HI, 
Mahopac, Md. 10541.— DJD 

AppleWorks international 

Is there a patch for the alphabetic sort in the 
AppfeWork.-, .'^.0 database such that foreign 
{e.g., German) characlcrs get sorted correctly? 
This would be l.he characlers A [91). a (123), 
(92), 6 (124), (93), ii (125) and J? ( 1261. They 
should be sorted with A, 0, U, and S respec- 
tively. I'm sure all those who are using other 
languages wouid appreciate this. 

Does anyone know where 1 can get a Ger- 
man character generator chip with mouse char- 
acters for my II enhancement? The one that 
comes with the enhancement kit fits American 
motherboards and has 24 pins; the German 



character ROM (part number 342-0275 for the 
upgrade) has 28 pins. Apple Computer in 
Cupertino informed me by phone that they 
could not supiwit It- a letter to them brought 
no reply. 

Terrell Smith 
Madison., Vlfec. 

Hie KppleWorlts 3.D enfenicflrtei#ate«a^^ 
v«Bthwhlte, ray only gpeF ls th^ Claris seeming- 
ly ifid not heed yotu" Sdvice to read the interna- 
tionally different ASCII characters ftom a table. 
The $7C character of vertical line shows up as 
a 6 on a lie using the German keyboard switch. 
Using the information in A2'CeBtrat on Apple- 
Works 2.0 1 had all $7C characters converted to 
exclamation marks and thought it easy to do 
the same to version 5.0, But the disk storage of 
3.0 is so different that a huge amount of work 
is involved. Before 1 go ahead I would like to 
know if some reader or organization has 
already come up with a scheme of where to 
look and what to change because 1 hate to reirv 
vent the wheel. 

Hans Wolter 
0N^, Vfesl Q&amy 

Bease h-h-help. 1 have been with you for 
some time and feel you are probably the best 
source of honest Information for my beloved 
Apple, 

I have recently upgraded to AppleWorks 3,0 
along with all of my favorite appJIcatfons, 

including the TimeOut series, 

Yet with all this power on my llgs and 64 
meg hard disk, 1 cannot yet create a custom 
dictionary to my liking. What I require is the 
ability for the AppleWorks dictionary to accept 
the I, I, I, ® characters to permit me to 
huild a French-Canadian custom dictionary with 
their equivalent characters e. e, u, 9, and a. As 
it now stands, when 1 invoke the open-apple-V 
command, AppleWorks accepts most words but 
once a foreign character is found AppleWorks 
breaks the word in two. As an example, 
TrangaSs" Would be constmed as 'Fran" -plus 
"ais",, 



if the AppleWorks dictionary could recognize 
these five lower ASCII characters it would per- 
mit the construction of a French dictionary that 
would properly respond lo approximately 95% 
of all spelling errors. The remaining words, 
those requiring the use of the ^ accent (circum- 
flex) such as "etre" and the ' (trema) such as 
'Ptoel" would be quickly veiffled using the old 
manual system, 

1 hope you or one of your readers could help 
me End a patch that would allow a more versa- 
ffle AppleWks 3.0 (Ecttqnaiy. 

Jean-fluy MaritQe 
Shannon, ^ebec 

Is there a way to print a f on an Apple 
through a software package or can it be dme 
through hardware itself without too much diM- 
culty? 

Fred Keinslein 
San Diego, Calif. 

'W'dmi have cam Jbr cusfamfzfnj Appk- 
Works 3.0 for intematHmMeitaracters. but per- 
haps one of our Oetfffe ^teaders may have 
developiid a palc/i. (Il/e'd iSie to point all 
AppleWorks patch Aactets toasetks by John 
"SttpttFattb' Link in The A^leWotliS 
Fartan, which provides detaih; for several 
AppteWarifs 3.0 patcbm.) Also, you may con- 
sider askSi^ <m of the campmes that has 
moMeid AppleWo^ for tntem^ional dime- 
ter such as Davka Corporation (see "Fot' 
eign Accents, cont.', Jan. 1990, p. 4.95) to 
see what options they can offer. 

We don't see a ions-term solulioti for text- 
based programs because their ctiaracler set is 
determined t)y the character ROM in use and 
the monitor routines which support it, which is 
part of the computer's firmware design. In the 
lie and lie. models were available with ROM 
and keyt>oard support 'localized" for specific 
countries: this was extended to the llgs by 
phicing several options in ROM and allowing 
the user to localize t/ie system by selecting the 
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wiir be Gonveited hrto the object on printout and placed In the area 
defined by the text box. To do this, you enable the Fublish-lt! 5.0 
PostScript attribute for the text object containing the EPS file whlie 
printing to a PostScript printer. 

You can also print the PostScript output for a document to a file on 
dish, and TimeWorl« includes a short section at the end of the 3,0 
update manual on how to print these files froin the Macintosh sys- 
tems often found at printing services. Our LaserWriter NT had bouble 
d^esling some of our test files, however. 

The program can also now import a IIg$ graphic (25^- 07 mentog^ 
Is required on a He or Dc) fmrn such programs as Deluxe F0il /J, 
8/16 Paint and FaintWorhs Gold, with the limitation that only the Rnt 
256 lines of a "tall" graphic will be imported. SHI^ graphics are 
imported in color and will be printed correctly in color, though the 
colors will be distorted on the screen display. Color can also be 
added to objects and texL 

Publish-lt! 3.0 now correctly supports the importation of Apple- 
Works 3.0 word processor files. It also allows the direct use of 11^5 
fonts, although Time Works cauffons' tfiat tSe £|tia% m^: oiX eqptNii 
that of the ftj6/isA-/W 3.0 fonts. 

tk^mlaa our hands oil Wiie$ae%tii^ i^bM^ Sieamiiac far the 
llgs; Vitesse also now reports they have software to support the scan- 
ner on a He or [I Plus. The Quickie consists of a hand-held scanning 
mechanism connected to the Apple II throu0i an biterface card Oiat 
can be installed in an internal slot. 

The llgs software includes a stand-alone application and an riDA 
that can access the scanner to import graphic data to the screen 



while in the Hgs's 200 super Mgh-resolulioM screen moic. 

The software includes selections to allow determining the length of 
the scanner's path {which can be many feet, though the width of the 
scanned image is limited to the scanner's dimension of about 4 inch- 
es) and options affecting the resolution and represent^ition of the 
scanned image (black and wtiite. gray scale, dithering) on the display. 

The scanner handles yay scale levels (no color), but currentty is 
limited by the storage format of the acquired data, which must be 
^ved a$ 3 6*0 mode g^phlc itapQe, The scanner resolution is 100, 
200, iSiiJj @r iiit per to^ {sefeed by a switcfr on tiie seanner 
bepid)- 

We found the scanner to be quick and easy to use, and It produced 

excellent results within the limitations of the 640-mode screen. We'd 
liKe to see either added support for using the 320-mode screen 
(which is capable of 16 gray levels per screen pixel), or a way of sav- 
ing raw data (as the ColorEyes video digitizer does) in such a manner 
as to allow further "massaging' by other programs. The Quickie is 
$299 from Vitesse, Inc., 13909/2A Amar Road, La Puente, Calif. 

91746, 818-813-1270 

B^^hemat^ Fmwa is a new neawstetter available from Hy^' 
imm^ WiiKOrtc Sox 103, aawetiburQ, 1.4 (^504, 6og466.|l9iB. 

Although the first issue (March 1990) expre^es a missicw ojF pomot- 
ing the use of hypermedia products for instructibii without naming a 

specific product, the initial articles seem to be solidly formed around 
HyperStudio. An individual membership in the HyperLearning net- 
work is $29 for one year, $55 for two years; institutioital mentiber- 
ships and other products are also available,— DJD 



ap^^fitMe 'WspSay Lati^agt' md 'keyboard 
Layout' settings in the control patiel (the physi- 
cs layout of the key caps on the keyboard 
would have to also be rearranged). But text- 
based prosrams used on the llgs still need 
software that is designed to support the special 
characters for the language in use. 

Graphics based procjrams don't liave to feel 
as iimited because the character display is not 
determined by a HON chaiacicr set. I'or enam- 
ple, AppleWorks GS can handle the intenu- 
tional characters and other characters from the 
"extended' ASCII cfmacter set in Us speSlng 
checker. 

A decision also has to be made where to 
define these extended characters in the set of 
fiSCli codes; for the Wcfs fonts we've looked at, 
the USA character set occupies ASat values 
fiom to 127, andOie intensationgl <^madets 



m mpt&s&i^ias of tfte set sfASCn 
ms mm 138 to 255. We t^^mt the Aj^e- 
Works GS debase and alphabetic sotting is 
handled strictly by numerical ASCII value. Most 
of ttie "international" characters are accessed 
by using the prefix keys described in 'Flore 
keyboard options" (Feb. 1990, p. 6.7a}, or by 
using ttie option key in conjunction with a 
character key. 

iVe ticcamc cuiious atmut the total range of 
characters siippoded, and decided to generate 
a table for a representative font (Courier). You 
can use the following ApplestM program to 
generate such a test filet 

1000 ItEM - gensHta Ml ASCII tabU - 
1010 LOHI»: 16384: SUi bistt foiw 
im E$ = CHR$ (1) 

1030 BBS - mzmeimast 



im TL = 0; RZM tatle length 
1100 Wi - gineiate table - 
1110 FOR I = TO 255 

112D : @m 2000; m fonat oonut vmba 
IW : SCSDS (fiil a«tt« itriag let &mi^ 
1140 : GOSDE 4000: SQt poke stiiug istO OBiDijr 

1145 iPEINT S$," TL= "/TL 

1150 : mm^ 

1155 BIX - iive table - 

m mini^rissm mi.Tm,Tm" 

1170 PRIHT D$;'BS»Q UCII,aBI£,mirl$2{|e!lr.r;® 

119S m 

2000 REM - fomat I to tut string - 

2010 1$ = 5m$ (It: ir l< 100 lEDI 1$ = '0" * 

It: 

IF I< 10 TBEN 1$ = *fl' + Ij 
2020 H$ = 'T + MD$ (BB$, HI (I / 16) ^ 1,1) 

+ mi [m.i - (IS * Txi (I / m + 

1,1): 

SZH do hex Atiaq 
2030 RETDPN 

3000 REM - ante string - 

3010 SS = I5 + M' + BO "I - " 

3998 RETCIQ) 

4000 REH - poke stiing ioto leioiy - 

1010 M K = 1 TO w im 

im ; ms tin + il, »sc ( mids (s$,i!,i)i 

4030 :TL = TL + 1 

4040 : mn K 

4050 POKE 8192 + TI,, I: BDItBllB 
4 .555 B. = in, + 1 

4^0' eeax ii@: * TZr^iar mtmm^. msm 

40G5 Tt » Br f 1:; m raliB 

(The file is written using the BSAVE command 
because BASICSYSTEH clears the high order 
bit on characters written to a standard TXT 
file.) The file can then be imported into a pro- 
gram and edited to generate a printout. W/j/ie 
editing, watch out for interpretations of certain 
controf codes,' farexam^e, the imb&kkd car- 
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riage return (ASCII 13) will generate a blanh 
line in your chart printout unless you edit that 
dmacter out. 

We edited our version of the table to encom- 
pass the printable cliaracters accessed eitiier 
by using an 'option<haracter" fhotii keys at 
ofiCL'j command, or by a combination of an 
option<haracter command foilowed by a sec- 
ond character. Vor example, ■< is generated by 
Option-!, ; by option- 1, and ' by option-u fol- 
lowed by a tnormai non-option} space. 

There are a few idiosyncrasies. First, The 
characters represented in our table are for the 
Courier character set; other character sets may 
differ in the contei^ of completeness of their 
character set representations. For example, 
Cairo is composed of graphic characters rather 
tlm the normaf printable characters we inter- 

tbe osmpfete ci&aBKter m fora km M i 
mt^ fSei cmiMe directly to what you aaoMly 
it0e aio^^bte In your program. For example, 
Jlj^ktMBiQSseem ta eUsnpffil a? contnd 
tHaeactS' cottes as fSiiM^ dmBtesm.- con- 
bfol-H (ASCn 13) /s executed as a an^^ 
return as expected, but ASCII characters $1 1 
(control-q), $!2 /control-r). $15 IcontroW and 
$14 (controls; from the Chicago font were not 
displayed with .AppleWorks GS in the print- 
able forms indicated by Bea^e Bros' GS Fait 

31, y, i, * lin the Chicoga font) 

(To add to the confusion, the Macintosh has 
elected to display ASCII $i I as the !^ac option 
key 'cloverleaC instead of the open-apple char- 
acter shown for the same charad&r in the 
Chicago Font we looked at.) 
Third, the font you have on screen may not 
cmelate to the font you see on the printout. 
Fiintli^ the document us//g the llgs imageWrit- 
er (blver (iMch sends a b^m^ of Oie tkKu- 
ismt im^ (o ^ pMe& 0m » imi^^ 

iag Qie seuse docemfH to the im^dter 
team M semai x^axK^ ^ufiisMdRS,- « 
HKife turned to a^iea Apjoife's des^p 
environment, what you see is not always what 
you get. For example, the * {option-^} charac- 
ter visible on screen did not print on the Laser- 
Writer from the llgs. The reason the substitu- 
tion occurs is that the LaserWriter driver is fed 
the QuickDraw 11 (rather than the bitmap) fonv 
of the document which includes separate defi- 
nitions for the graphics and text elements of 
the page image us displayed on the screen. 
When the fe.vf is processed into PostScript it 
is converted to A5C.H character codes that the 
LaserWriter is expected to print as tlie charac- 
ters wc see dispLiycd in the text on screen. 
(We've seen dissimilar weirdness on the Mac in 
different circumstances. We mention this ta 
indicate that non-WYSIWIQ output is not a 
problem unique to the llgs.) Unfortunately, the 
LaserWriter character codes apparently don't 
match up. The ImageWriter iinege Is "couecf 
since it is esxatiaUy a ^bi^sc printout of the 

A mute Ukn mir tl^baiied ASCa K^ Equiva- 
lents' mtite piertem ps^se ins a fisractica/ pur- 
p<m: tt 0& yfm a t^'Sfwce t& imm which 
(Imacbets art aM^ibte ott sctten aM in your 
printout, and (for the selected codes we've 
included) how to generate them from the key- 
board. For the llgs, you need to use the option- 
key mapping, which does not correlate to the 



.ASCII order of the keys bi ttc A^l chart. So 
we have an additional column in the table that 
shows the option-character equivalents for the 
(US) heytioard layout, along with the few that 
also have a shifted equivalent (option-shift- 
character). We can't reproduce the table for all 
foreign keyboards, but if you can locate a Mac- 
intosh user manual you may Hnd it contains a 
keyboard diagram with similar infmnation (our 
Macintosh SF manual had the keyboard derini- 
tions on pd(/e Luohimj at the table, it 
turns out that the £ character can t>e generated 
by the oplion-3 keyboard sequence, and the 
German essett (fi) character by options (notke 
that is a lower case 's"). 

The extended characters can also be g/en&M' 
ed with TimeOut Supetfonts; check youttttStf^ 
ual for inform^ion n^ardjr^ the <xJ?'. <3c2^ 
and <x5> coni^nds fx accesi% 

i4KpecfA%« IJie Sam ttttAS^^V- 
akrA in the ran^ of @ (ASai 64) to ' (ASCII 
254). We see from our ASOl chart that £ is 
ASCII 163 which lies In the <X2> range; 163 
minus 12$ /s 35. AdiSng 35 to 64 gives us 'c' 
gmietmse) ^omaoimatASCBequiv^ent sd 
we use 'tai2>c<xl>' as oar Supe^foats 
sequence to generate £ on the printout. The 
exception is ASCII values 191 (our 0} and 255 
(undefmed for our chart); normal .-ISCf/ charac- 
ter 127 is the non-printable 'Delete" key, so 
'?' is used in it s place. 

After hours Investigating this, we aren't sure 
we have all the loose ends tied down,- for 
example, we tested this all on our decidedly 
USA llgs. We have included the tables so thai 
others can experiment; we haven't seen the 
information compiled in one place anywhere 
else and we're among the people who need to 
use it occa.sionally. ^ow at /east wn'ti be aiiie 
to Find itI-tXJD 

AppleTalk and WordPerfect 

iWm Wonffeiket and I need imm^ ptoces- 
sor like it because ol ite fbotaote and ii)|ihefr 
ation pos^tWes. Add wittt the latest ve^skn 
evoytniiiB woited fine, unfit [ £^ to prunt with 
an little IjaeerWiiter II TIT. 

mk, I printed vta' tte Jl^petaDi, netwcKk It 
printed, biit the results were 1>ad. the worst 
prfntfng happened with accents. 

Then t tried to print via the IWEM (ImageWrit- 
er Emulator) to slot 7; nothing happened. 

I hope someone can help me with this. I also 
have written to WorxIPcrfect Corporation, but it 
could be that you or a reader might have the 
right answer. I li^jve 1801) parjes in IVordPerfect 
I'ormal with (i'rynch) atrents and therefore I'm 
longing for a solution. 

I would also lit\e to know if it i.s possible to 
make the LtiserWriter [)rint in the emulation 
mode with foreign characters (like the way it 
can t>e dane with the real ImageWriterl . 

JDigen Woretschofer 
Haasti!dit,neQteriands 

We do not use HimrifWlKt at M at JO- 
CeaSnS: possibly a /eader has a suages^. 

The LaserWriter's ImagsWr&er emulsion 
does support foreign characters;. Since you 
can't open the lid and change the DIF switch 
settings as on the ImageWriter, you need to 
send the appropriate .software commands as 
part of your printer initialization. For example, 
the sequence to use the Danish characters is 
Escape Z Control-E Control-§ Escape D Con- 
trois Cotttroi^.—DJD 



Math coprocessors 

Please consider rei>i«i^ math ooproGessras 
for the ne and tigs. fbOHfs a ^^ple on ihe 
market: FFE (noatins AjM and Qsa 

Applied Engineering FiBlMa^. 

My interest is llgs specific. Will a coprocessor 
speed up screen display and computation of 
objects In object drawing applications such as 
Top Draw? Does it improve performance of 
AppleWorks G5 spread^eet graphics, and 
dataiiase modules? 

Dan Bench fr 
Cfndnatti, Ohio 

For an idea of the relative performance of 
the hardware for the pfe and the Fastmath. 
check the times given in the January 1990 
'Miscellanea' column using the Beag^ Com- 
Piter's interface routines. The fFE was Hie 
dear wim&. M these: not itOmsbed io Ok 
lOtm^ In p&kmmmrmif MKb toJack^ Qte 
lower pike d We BmlAU ito flieir pur- 
chase equation. 

As your ii^rest is ll^pedfiCt &ie tk>aUias 
faiit ib^ae ^ the only reaU^ aMeniaBm 
B wWrfl r's AardHiane does Met pi&0e the 
SME standard Af^numaks BmnHmnant) 
compatibility necessary to ai^ent the U^' or 
(classic) AppleWorks' use of the SAFiE model 
for floating point calculations. 

Be clear on the point that a floating point 
coprocessor only speeds up calculations. The 
FFT will accelerate AppleWorIa GS's spread- 
sheet recalculations, for example, because the 
FPE includes a routine to cmise calls to the 
llgs SAHE routines (by any program) to be rout- 
ed through the Fli instead. Graphics that 
depend on a great many SAriF. calculations 
(such as a fracta! prot^ram that calls SAFiE to 
calculate the points to plot) will be sped up by 
the virtue of quicker calculations, not by any 
acceleration in the actual {dotting of points to 
dtspta^ the graph. West ^enerat painting or 
drm/b^ fmgrams wtm't useS^ to ca/cu/jle 
Oie form ofUK t^^ect they ax commanded to 
drm because the objerifs bnage can be ren- 
dered more quickly and adequatdy for display 
pmpos^byusif^oOKTtechmqae&'^W 

Carry me away 

Do you know of any ccmpany that makes car- 
rying cases for the Apple II like they have for 
thenac? 

Paul Christia/ison 
Lancaster, Calif. 

We haven't seen a specific llgs case adver- 
tised. The llgs monitor and CFU might fit in 
cases designed for a compact Mac Ilex style of 
system (the llgs components are a bit mwilet 
than their Mac counterparts). 

Targus manufactures a soft case called ttm 
Lappac 2 Deluxe {$99.95 suggested retail for 
woven vinyl, $219 for the leather ver^) Otat 
has MeOoF iMaiskm at irtig IAS' t^ 4* 
Mei^ M a range of Ji^:^ ml 
pottahle ^fStians (fnc/udfflg the lie iBodeiUt 
Stficft a case mmlda't house the llgs timSttif 
but WDUfd probatity be adequate to tmy the 
CFU, an extern^ diive or two, and the neces- 
sarj' cables. The case has a padded irAaasi 
divider that splits the large compartment into 
two sections; one could be used for the CFU 
and the other for a 3.5 drive and cables. The 
itttiaior cf the 'M' has pockets ^mM:^ 
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d^^ied for 3. S (Ms, husiBe^ eanh, aid 
iMig bspkimnts, as wdl as a largo: podnet 
Sx ms. There ate outer pocMs de^^Kd fo 
JaHlage Aetits, possi^s mof^ orei^^ 
raigiis abo sefls otiter cases; ^ey 5eff 
throng desSeis, so you mafy ffiKi the Lappac 2 
case at dealers that cany WS-DOS computers 
aid accessories. Mac Connection, 14 MUl 
Street, Marlow, n.tl. 05456, 800-334A444 or 
603446-779 1 1 sells Tmgus cases for the Mac 
Ilex ($75} and the /mage Writer ;/ m5); the ilex 
case mighf be stdtabk hr Hie m^tr 1^ CFV 
Mid keyboard. 

Another source to check might he youf local 
music instrument store; the places that sell 
keyboards, guitars, electronics, etc. to profes- 
sonal musicians. Those instruments need hard 
shell cases to protect them "on the road", and 
some of the case suppiiets will actually config- 
ure a case to match your requirements. Audio- 
visu^ equ/pment defers may also be a place 
to diedt—tUD 

Dtsk Identification 

iSack in Vo\vm 2, tbtmber 12 tianuary 
1967) you showed us how fa iegeisciQe Smanport 
coBunaiKlSa IWs lufdiTnaHos perndts ok to 
deb^ Bie pnsmx oT a 1^ Uiat uses 
^nartl^Mt ppsitoca. In Vblimie % fliiiober B. 
Alaii SIver shows how to detecil a 'W^ ^ic 
that does not use the SmartFot protocoL Both 
of these ideas work fine. 

My problem is Lhis: once I have detected a 
SmaitPort RAM volume (under FroDOS 8i how 
do I find its ProDOS volume name so that 1 can 
do a QET.FILEjriFO Ml.l call to find out how 
many tree blocKs the volume has? (The Smart- 
Fort device status call only returns the total 
niimlier of blocks, not the number of blocKs 
used or the number of blocks free.) I need lo 
know If the KAM volume has sufficient unused 
storage space for my program's temporary files. 

The method 1 am currently u^ng is to do a 
OET.riLEjriFO call for each online volume and 
compare The 'total blocks' of that volume with 
the number of blocks that was returned in the 
SmartPOrt Device Information Block for the 
SmartPOit RAM disk. When they're equal, I 
assume I've found the SmaitFoit BAM voiume. 
Thb technique dares to assume Saat Ok RAH 
volume wtll lie\«r l)ie ^Cictly the sanne as 
anyotboroi^ lKtiiUiie, So far I've luc^d gtit, 
but sooner or tater one of my programs Is 
tot m ui» asabisC a volume tbift Is the 
satite stee as art onfine floppy disk, (a other 
jjtaclwjriented device, and my method will b^e 



the dust. What can I do? 

Robert C. Moore 
Laurel, Md. 

^ppfe lias re/eased two FroDOS 8 Technical 
Notes you should read: if 20 ('Mirrored Devices 
and SmartFoft') and #21 (~ Identifying FroDOS 
Devices'). (Apple Technical notes are wonder- 
ful things and are h^ly recommended to seri- 
ous [mjgrammers.) These clarify the identirica- 
Uoii ofFtoDOS (disk) devices. 

Basically, if you have isolated where the 
RAM dish is so that you know the slot and drive 
assigned to it, then you have it's ftoDOS unit 
number. The unit number fomiat is DSSSOOOO 
(in i^rmyj, where D isO for drive 1 or i for 
drhe 2, anH SSlS b the three bytes ref^isea- 
ing Sie slpf mm^. BieBeftw, if you hsm a 
MPf dbil tAat jippeas makAAas drive I, ^ 
HflSf Bimbet would be 01000000 ($40 m hex; 
64 decimal). 



The mWIW^MS) mtOmm unit 
tmmter as fimt <if Ss pamK^ hSock. if yoa 
Bse the ^peofe number for ffie deti% of 
tntemt, OnSyMS v^ return the volume name 
for dm devfce in (he buffer you specffy. As an 
ample, executing: 

JSl ML! leiecote HLI coDUlld 

D7B OMLUS ,' O&liae csll 

Di QLPARNS ; ootpuMten 

BCS BSOR ,']WB£)fr &tis 

QtfARtiS DFB $92 ;t«o panseteis 
DFB $40 ;6lot i, drive 1 
DS OOHBWR ;our buffer location 

would return the volume name information at 
location OUfrnum The actual form of the 
bitormaSlin Us a byte 3t OlffSStWR which con- 
tafss Oie i)«it AutnA^of ffie^eilce 91 Ok 
onfer Rmt b^ Uie kr^ mm rHissy 
ftdbC& vdiiam ^mta bs ^device in the 
Umader four bSs (f £te ieWce Is empty. Oils 
valae Is xio}, mi m ASCII text (h^ M 
dear) for the w»fiinte ftame beginning at the 
byte following OURBUm (In this case, the text 
of the volume name does not contain the lead- 
ins '/* normally associated with FroDOS vol- 
ume names.) If things don't go well, Fossible 
errors are $28 (no device connected), $52 {not 
a FroDOS disk), and $2 7 (disk I/O error). . 

With the volume name, you can now do a 
QET_rilEjnFO call (See "Butterflies turn to 
womK". Oct. 1985) lo return the information 
for the volume directory "We". For a volume 
directory, the field that normally would indicate 
an auxiliary type actually indicates the total 
number of blocks on Ihe volume. Subtracting 
the Mocte used from the total blocks gives, of 
a^ae, the bkKhs fiee,—DJD 

ligs programming in C 

How at>out canjiii^ some Jmohs oii pogram- 
mbig In C? Espi^^ afyseeODt to the 
todbox. 

dlenni&ftfs&^ 
Or^tttH,;^ 

We Mom of a few good ixjdks on C plO' 
g^mn^ Mga&alf we 9^ most of Oi^ tm 
(he shelves at normair bocAstores so we 
bavent bothered to try and sell them our- 
se/ves. We've stuck primarily to Apple II specif 
ic bool^ that might be someiKhat hmder to 
locate locally. 

There is no single 'lIgs Toolbox program- 
ming in C" reference that is topically current 
thai we are aware of. Overall, you probably 
shouldn't assume that such a book will exist in 
the near future; books take several months lo 
write and at the rale Ihe lIgs System Software 
is changing right now any book written from 
current knowledge would probably not be com- 
prehensive by Ihc lime it is finished. The lIgs C 
compilers available now (AFWCand OKCA/C) 
are also still being improved. 

This does not mean there is a Ixh of hope; 
books on toofJkM programming do exist (see 
'Desktop programming help': p. 6.2 1 of last 
month's issue); though most e.\amples are in 
assembly language, by and large the principles 
apply to high level languages as well. Tool calls 
do rat Jook that distinct between various lan- 
guifgeK bi every rase It Is a matter of allocating 
&e necessary data stuctiims and Just ca£li^ 
fie cmea rwSne. 

The important fyctor Is unders^wiSsg the 
language you are using (be lt assembty, BASIC, 



/%Bcal C w ofiier; well esnoei^ to jbe^bte to 
oeate the program k^ aec^amy ta pmMe 
me framewom aad m^fcrnhmt for ttelMi^ 
tilt toolbox calls. TMs means ym shou/rf temn 
the language itself fbst before trymg to peifonn 
Smctkxa specific to a paftfcutv system. Its 
Qte same principle as learning cAemKby 
before trying to make nitro^ycerin. 

Apple's Frogranam's Ailrodad/on to the 
Ap^e lIgs contains the complete source code 
for the demonstration HodgeFodge applica- 
tion in assembly language, Fascal, and C. Pas- 
cal is used for the text of the book, but you 
could flip back to the index and look at the 
equivalent C code. Cecil Fretwell has convert- 
ed the code for Programmiag the Appie figs 
IB Assembly Language to C source or? disk, 
and you could also get that disk, print out the 
source files, and follow along with the book 
with C source in hand. The crucial step is to 
know eaou^ Cto be able to understand the 
e)attipks.—l3JD 

l^stollBASICaUy 

IIA wUtag a Krte game of own in 
im tmC f know Ms wwits inm the Apple 
n^, but can you reoommead aie^ language or 
program like ITIL tliat WOrta (HI eariier Apples, 
i.e. lie, lie? I'd Uke my game to lie av^lable for 
these people, too. 

Harold Reynolds 
Minnetonka, MM 

If you're looking for a BASIC compiler, the & 
bit Apple II options are nicol Advanced 
BASIC for Ihe Apple He and He ZBASIC, cr 
using Applesoft and the Beagle Compiler. 

Actually, since you have a lIgs, there Is anoth- 
er alternative; Morgan Davis has annamxed 
fBHIXSC. a "preprocessor' which aiSam 
the OgCAM v ASV 1^ aj^p^emff- 
foomenf to Iransfate^ Mni^KedBt^ somee 
Se b^^^jpksofi, M^kh can tlm be am^ed 
Bit Bei^ Comj^a. As an exmple, the 
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TriTial SUIpl« for K>-BASIC 
'eomtait definiUoii 
tddiM KtyDitiXig 

WBJm nfSLUM 

Haas dl^iitiM 

Miin; 
TEB 
ECtB 

OffiRR GOIO thttsot 

BEBf H^: •? 

SaitTorKey 

Key = PEE!((lleyDataReg] 
CleuMy 

FUR* MCn ooda s 

ELS 

mm * QinctH • "iOBRtfx^f} 

EXIT 

DHTIL Key = $SD 'Hit fe dMiini> 
PMHT 'But'* »11!" 
fOa 216,0 'cancel 
m 'Hiia' 
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trmalatestolhls: 

100 TSXT 

lie EWE 

120 CHCtR Qim 250 
130 PRIKT ■■■■Key?; 

liOHUT -mu,m 
mm' pm I - urn} 

mm warn <isoi sgsozoo 
mam" lamom^'sm 

IfOSDlOltO 

200 EBir ■ Chanetac = ^ CBR} {Or) 
21D If nr (lit e 141) nsr i30 

220 PRIST "liat's ill!' 
230 eOIS 215,0 
240 EMD 
250 eSSUHE 

{Sfter a pass through the MD-BASIC jgepmeS' 
sot Qf^vaSion 'off. Time's esm a 
'decba^^f to convert exii^ pm- 

aihsm&l ^tmsto dSmkate smeoftiie pit 
6S$ or mti^ j^i^le^mt- ^^etO^on. no Une 
imib&s, ext&iS^ vailaMe smm, piepeoces- 
<sor maaos, and so on} as can be seen In the 
sample above. The ffiMIASIC preprocessor Is 
a shell utility that works on files edited with the 
OKCA/H llgs or AFW editors, hence the need 
for the ORCA/n or AFIII enyironmenl WD- 
0A5IC a/50 includes AmperVllorks, a set of 
ampersand t°St') enhancements to Applesoft 
MD-BASlC is $49.95 from the Morgan Davis 
Oroap, I00T9 Nuerto Lane, i^ncho San Kego, 
Calif. 92078-1736, 6l9-670-()563. 



The suitability of any of these alternatives 
depends closely on the number of specific IML 
BASIC features you mjy have used regarding 
access of llie llgs toolbox, and for specific 
uses such as graphics, tor eAamp/e, Mfctrf 
Advanced BASIC and SSASIC both have 
some graphics commands extensions to draw 
circles and other objects on the graphics 
screen; in Applesoft (and MD-BAS/O, such fea- 
tures are absent and you would ha^e lo write 
your own subroutines. (no-BASlC has an 
'^include" instruction thai allows subroutine 
source to be Imported info afBest 'compfite' 
lime.'h-DJS) 

llgs modem help 

I would like to add a modem to my llgs to 
take advantage of your QEnie service. I have 
AppleWori\s 05 which has a communications 
module. Ftease offer suggestions or Uteraluie 
which would guide me in firmware, hairdiisaie, 
software, etc and espedally instaUatMi pF£ii(%« 
dures. 

FeterOrio 
Twelebuiy, MA 

Our back issues have some information on 
modems in general and connecting to Glinie in 
particular; the pertinent articles are 'Mainframe 
QEnie at your service' (Feb. 1988), "Crossing 
telephones with computers" IMar. 1988), and 
'Twisting talk into data' (.May 1988). 

Wilh your modem installed, the AppleWorks 
GS manual should be adequate to get you up 
and running, though if you're Icniking for practi- 
cal lips you might find another reference 
handy. We've heard good things about Que 
books, and a lodt at their new U^qg ^ple- 
Works C3 cmvlimd us to fndude It in mr 
catalog. 

One note you woa't Wd ln the books; System 
Softwans 5.0,2 ^ a mett bug- In die $GSf 
dtirn Ifiat £8^ ciiise AffpleWovis CiS Wmy 
raOve 1^ coaununfcaf/ons program) {a jfe 
ii^fi a OTor indkating the program Has 
received too many inteimpts. Claris has some 
suggestions on dealing with this problem for 
now, which we anticipate is on the 'redress' 
list for any future system software release. The 
SCSI drivers for Apple's new tligh-Speed SCSI 
Card t which also includes a minor QS/OS revi- 
sion to version 3.2) apparently sW! allow the 
error to be generated, but the system will allow 
you to recover TStim (ftau Ibrcftqj a 
reboot.— DJD 

Don't do (too many) windows 

I own a llcjs and am always looking out for 
new graphics and font programs. Recently I 
incorporated several new fonts from Qraph- 
/cWr/ter into both AppleWorks OS 1.0 and 1,1. 
In both cases I have run into the same problem: 
I can't print (1 eittier get 'Can't print this docu- 
ment" or 'ftot eiough menwry to onni^ete', 
etc) if I have more than one window open. ) 
was using a graphics page but it only had mint 
tnal black mA white ad; and a name wdtten &m 
or sk thn^ tdrg ctt^nt fpr^ Ts thts pi^ 
lem due to these fonts being in gtieq)iilc mode? 
Any suggestions? 

JohnRe^d 
Simi VEdley, Caltf. 

We mentioned the problems of memory 
constraints last month ('Serious errors', pp. 
6.1 1 12). One thing we didn't mention is that 
open windows are one of tfie thing$ that can 
eat menmy, !n a<U^ to multsfie foeSs. If 



memory is very tight and you have an idle (or 
expendable) document window open, close it; 
it may get you through the ne>tt operation, but 
only if the difference is a few thousand tiyies 
(windows don't use that much memo/}). 

fofifs, graphic objects (including tho.se used 
by the system, such as windows), and many 
other items can affect memory use. Apple' 
Works GS allows you to see how much memo- 
ry you have free as part of a .status report 
shown when you hold down the Option key 
and pull down the 'About AppleWorks OS...' 
item from the Apple menu. If you are chroni- 
ca//y short of memory [after stripping out any- 
thing expendable in the way of desk acces- 
sories, RAM disk space, etci, the only perma- 
nent answer is to get a lager metaoiy eiqm^ 
slon card.—DJD 

Too much power? 

Well, I had a quiet chucMe when I irad Vetn 
Hastel's ^de in last month's navsletter about 
tiS^&m #eedji asd caf>abDilies of the NSOOS 
and^^ilspteins, 

I am one (H a team of nine people scj^eied 
sound WMa &t^^&i in communis devetop- 
meftt woftt, Por the Ijsr three yeara I have used 
a computer for numerous tasks involving lots of 
word processing, low level desktop publishing, 
databases, statistical analysis and plenty more, 

Recently. I prepared a paper on the computer 
needs of rny fellow workers with a vicw' to hav- 
ing them equiijped for the task. The paper out- 
lined our need.s, based on what I had been 
doiny, and was .submitted to the computer 
experts of our organization for appraisal. The 
"experts" came back with a recommendation 
thai we be equipped with MS-DOS compatible 
desktop 286/.3a6 with VQA monitors. 110 
megabyte hard disks and laser printers. Sound- 
ed pretty good to me. The only fly in the oint- 
ment, however, was that I had been doing all 
my work on a I28K lie, standard monitor, 20 
meg SCSI drive (although my software runs hap- 
pily off floppy (flsk) and Cttympla dot matiix 

There's Ho #Nfit mmUL It. tte potfsitia! of 
the more i»?u«tftil fiimiWtss tsi Blind bog^ljng. 
Unfortunate^ I eaa^C affiocd &e ttuaaj^ of a t3«g^ 
gled mihd/j've gii teioinueh we^tade bt tite 
real weitd. Ilie nta^es saggtst a learn- 
ing curve ffite thg norttt ^ of the Matteiltom; 
okay for masochiste but not much fun fw the 
rest of us. 

I think well probably end up with laptops 
which makes more sense (we're a pretty^mobl!e^ 

bunch), but i am as keen as mustard to geniFiat 
Hewlett Packard laser printer running under 
AppleWorks .'5,0, D5 Master Pro, and Frinlrix'. 

Incidentally, the April newsletter was 
great— more positive than I've seen In quite a 
while, plus lots of useful tips. 

Ballarat>nc 
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It looks like the portable lie would be a 
good choice for you, too. CMvfUfHtefjf, m 
kimed tlt^ ikgo' Ci^ @afl m !w0i e^tsin 
t-Vae LCD screen ^ftmSpm^ In list 
mtMH's 'Penrnnent por^e //c'7 U 
uAkA much hills the use of s He as a 
baOaypow&ed pcvtatde.-M) 



